﻿/*
 * FCKeditor - The text editor for Internet - http://www.fckeditor.net
 * Copyright (C) 2003-2009 Frederico Caldeira Knabben
 *
 * == BEGIN LICENSE ==
 *
 * Licensed under the terms of any of the following licenses at your
 * choice:
 *
 *  - GNU General Public License Version 2 or later (the "GPL")
 *    http://www.gnu.org/licenses/gpl.html
 *
 *  - GNU Lesser General Public License Version 2.1 or later (the "LGPL")
 *    http://www.gnu.org/licenses/lgpl.html
 *
 *  - Mozilla Public License Version 1.1 or later (the "MPL")
 *    http://www.mozilla.org/MPL/MPL-1.1.html
 *
 * == END LICENSE ==
 *
 * Manage table operations.
 */

var FCKTableHandler = new Object() ;

FCKTableHandler.InsertRow = function( insertBefore )
{
    // Get the row where the selection is placed in.
    var oRow = FCKSelection.MoveToAncestorNode( 'TR' ) ;
    if ( !oRow ) return ;

    // Create a clone of the row.
    var oNewRow = oRow.cloneNode( true ) ;

    // Insert the new row (copy) before of it.
    oRow.parentNode.insertBefore( oNewRow, oRow ) ;

    // Clean one of the rows to produce the illusion of inserting an empty row before or after.
    FCKTableHandler.ClearRow( insertBefore ? oNewRow : oRow ) ;
}

FCKTableHandler.DeleteRows = function( row )
{
    // If no row has been passed as a parameter,
    // then get the row( s ) containing the cells where the selection is placed in.
    // If user selected multiple rows ( by selecting multiple cells ), walk
    // the selected cell list and delete the rows containing the selected cells
    if ( ! row )
    {
        var aCells = FCKTableHandler.GetSelectedCells() ;
        var aRowsToDelete = new Array() ;
        //queue up the rows -- it's possible ( and likely ) that we may get duplicates
        for ( var i = 0; i < aCells.length; i++ )
        {
            var oRow = aCells[i].parentNode ;
            aRowsToDelete[oRow.rowIndex] = oRow ;
        }
        for ( var i = aRowsToDelete.length; i >= 0; i-- )
        {
            if ( aRowsToDelete[i] )
                FCKTableHandler.DeleteRows( aRowsToDelete[i] );
        }
        return ;
    }

    // Get the row's table.
    var oTable = FCKTools.GetElementAscensor( row, 'TABLE' ) ;

    // If just one row is available then delete the entire table.
    if ( oTable.rows.length == 1 )
    {
        FCKTableHandler.DeleteTable( oTable ) ;
        return ;
    }

    // Delete the row.
    row.parentNode.removeChild( row ) ;
}

FCKTableHandler.DeleteTable = function( table )
{
    // If no table has been passed as a parameter,
    // then get the table where the selection is placed in.
    if ( !table )
    {
        table = FCKSelection.GetSelectedElement() ;
        if ( !table || table.tagName != 'TABLE' )
            table = FCKSelection.MoveToAncestorNode( 'TABLE' ) ;
    }
    if ( !table ) return ;

    // Delete the table.
    FCKSelection.SelectNode( table ) ;
    FCKSelection.Collapse();

    // if the table is wrapped with a singleton <p> ( or something similar ), remove
    // the surrounding tag -- which likely won't show after deletion anyway
    if ( table.parentNode.childNodes.length == 1 )
        table.parentNode.parentNode.removeChild( table.parentNode );
    else
        table.parentNode.removeChild( table  ) ;
}

FCKTableHandler.InsertColumn = function( insertBefore )
{
    // Get the cell where the selection is placed in.
    var oCell = null ;
    var nodes = this.GetSelectedCells() ;

    if ( nodes && nodes.length )
        oCell = nodes[ insertBefore ? 0 : ( nodes.length - 1 ) ] ;

    if ( ! oCell )
        return ;

    // Get the cell's table.
    var oTable = FCKTools.GetElementAscensor( oCell, 'TABLE' ) ;

    var iIndex = oCell.cellIndex ;

    // Loop through all rows available in the table.
    for ( var i = 0 ; i < oTable.rows.length ; i++ )
    {
        // Get the row.
        var oRow = oTable.rows[i] ;

        // If the row doesn't have enough cells, ignore it.
        if ( oRow.cells.length < ( iIndex + 1 ) )
            continue ;

        oCell = oRow.cells[iIndex].cloneNode(false) ;

        if ( FCKBrowserInfo.IsGeckoLike )
            FCKTools.AppendBogusBr( oCell ) ;

        // Get back the currently selected cell.
        var oBaseCell = oRow.cells[iIndex] ;

        oRow.insertBefore( oCell, ( insertBefore ? oBaseCell : oBaseCell.nextSibling ) ) ;
    }
}

FCKTableHandler.DeleteColumns = function( oCell )
{
    // if user selected multiple cols ( by selecting multiple cells ), walk
    // the selected cell list and delete the rows containing the selected cells
    if ( !oCell  )
    {
        var aColsToDelete = FCKTableHandler.GetSelectedCells();
        for ( var i = aColsToDelete.length; i >= 0; i--  )
        {
            if ( aColsToDelete[i]  )
                FCKTableHandler.DeleteColumns( aColsToDelete[i]  );
        }
        return;
    }

    if ( !oCell ) return ;

    // Get the cell's table.
    var oTable = FCKTools.GetElementAscensor( oCell, 'TABLE' ) ;

    // Get the cell index.
    var iIndex = oCell.cellIndex ;

    // Loop throw all rows (from down to up, because it's possible that some
    // rows will be deleted).
    for ( var i = oTable.rows.length - 1 ; i >= 0 ; i-- )
    {
        // Get the row.
        var oRow = oTable.rows[i] ;

        // If the cell to be removed is the first one and the row has just one cell.
        if ( iIndex == 0 && oRow.cells.length == 1 )
        {
            // Remove the entire row.
            FCKTableHandler.DeleteRows( oRow ) ;
            continue ;
        }

        // If the cell to be removed exists the delete it.
        if ( oRow.cells[iIndex] )
            oRow.removeChild( oRow.cells[iIndex] ) ;
    }
}

FCKTableHandler.InsertCell = function( cell, insertBefore )
{
    // Get the cell where the selection is placed in.
    var oCell = null ;
    var nodes = this.GetSelectedCells() ;
    if ( nodes && nodes.length )
        oCell = nodes[ insertBefore ? 0 : ( nodes.length - 1 ) ] ;
    if ( ! oCell )
        return null ;

    // Create the new cell element to be added.
    var oNewCell = FCK.EditorDocument.createElement( 'TD' ) ;
    if ( FCKBrowserInfo.IsGeckoLike )
        FCKTools.AppendBogusBr( oNewCell ) ;

    if ( !insertBefore && oCell.cellIndex == oCell.parentNode.cells.length - 1 )
        oCell.parentNode.appendChild( oNewCell ) ;
    else
        oCell.parentNode.insertBefore( oNewCell, insertBefore ? oCell : oCell.nextSibling ) ;

    return oNewCell ;
}

FCKTableHandler.DeleteCell = function( cell )
{
    // If this is the last cell in the row.
    if ( cell.parentNode.cells.length == 1 )
    {
        // Delete the entire row.
        FCKTableHandler.DeleteRows( cell.parentNode ) ;
        return ;
    }

    // Delete the cell from the row.
    cell.parentNode.removeChild( cell ) ;
}

FCKTableHandler.DeleteCells = function()
{
    var aCells = FCKTableHandler.GetSelectedCells() ;

    for ( var i = aCells.length - 1 ; i >= 0  ; i-- )
    {
        FCKTableHandler.DeleteCell( aCells[i] ) ;
    }
}

FCKTableHandler._MarkCells = function( cells, label )
{
    for ( var i = 0 ; i < cells.length ; i++ )
        cells[i][label] = true ;
}

FCKTableHandler._UnmarkCells = function( cells, label )
{
    for ( var i = 0 ; i < cells.length ; i++ )
    {
        FCKDomTools.ClearElementJSProperty(cells[i], label ) ;
    }
}

FCKTableHandler._ReplaceCellsByMarker = function( tableMap, marker, substitute )
{
    for ( var i = 0 ; i < tableMap.length ; i++ )
    {
        for ( var j = 0 ; j < tableMap[i].length ; j++ )
        {
            if ( tableMap[i][j][marker] )
                tableMap[i][j] = substitute ;
        }
    }
}

FCKTableHandler._GetMarkerGeometry = function( tableMap, rowIdx, colIdx, markerName )
{
    var selectionWidth = 0 ;
    var selectionHeight = 0 ;
    var cellsLeft = 0 ;
    var cellsUp = 0 ;
    for ( var i = colIdx ; tableMap[rowIdx][i] && tableMap[rowIdx][i][markerName] ; i++ )
        selectionWidth++ ;
    for ( var i = colIdx - 1 ; tableMap[rowIdx][i] && tableMap[rowIdx][i][markerName] ; i-- )
    {
        selectionWidth++ ;
        cellsLeft++ ;
    }
    for ( var i = rowIdx ; tableMap[i] && tableMap[i][colIdx] && tableMap[i][colIdx][markerName] ; i++ )
        selectionHeight++ ;
    for ( var i = rowIdx - 1 ; tableMap[i] && tableMap[i][colIdx] && tableMap[i][colIdx][markerName] ; i-- )
    {
        selectionHeight++ ;
        cellsUp++ ;
    }
    return { 'width' : selectionWidth, 'height' : selectionHeight, 'x' : cellsLeft, 'y' : cellsUp } ;
}

FCKTableHandler.CheckIsSelectionRectangular = function()
{
    // If every row and column in an area on a plane are of the same width and height,
    // Then the area is a rectangle.
    var cells = FCKTableHandler.GetSelectedCells() ;
    if ( cells.length < 1 )
        return false ;

    // Check if the selected cells are all in the same table section (thead, tfoot or tbody)
    for (var i = 0; i < cells.length; i++)
    {
        if ( cells[i].parentNode.parentNode != cells[0].parentNode.parentNode )
            return false ;
    }

    this._MarkCells( cells, '_CellSelected' ) ;

    var tableMap = this._CreateTableMap( cells[0] ) ;
    var rowIdx = cells[0].parentNode.rowIndex ;
    var colIdx = this._GetCellIndexSpan( tableMap, rowIdx, cells[0] ) ;

    var geometry = this._GetMarkerGeometry( tableMap, rowIdx, colIdx, '_CellSelected' ) ;
    var baseColIdx = colIdx - geometry.x ;
    var baseRowIdx = rowIdx - geometry.y ;

    if ( geometry.width >= geometry.height )
    {
        for ( colIdx = baseColIdx ; colIdx < baseColIdx + geometry.width ; colIdx++ )
        {
            rowIdx = baseRowIdx + ( colIdx - baseColIdx ) % geometry.height ;
            if ( ! tableMap[rowIdx] || ! tableMap[rowIdx][colIdx] )
            {
                this._UnmarkCells( cells, '_CellSelected' ) ;
                return false ;
            }
            var g = this._GetMarkerGeometry( tableMap, rowIdx, colIdx, '_CellSelected' ) ;
            if ( g.width != geometry.width || g.height != geometry.height )
            {
                this._UnmarkCells( cells, '_CellSelected' ) ;
                return false ;
            }
        }
    }
    else
    {
        for ( rowIdx = baseRowIdx ; rowIdx < baseRowIdx + geometry.height ; rowIdx++ )
        {
            colIdx = baseColIdx + ( rowIdx - baseRowIdx ) % geometry.width ;
            if ( ! tableMap[rowIdx] || ! tableMap[rowIdx][colIdx] )
            {
                this._UnmarkCells( cells, '_CellSelected' ) ;
                return false ;
            }
            var g = this._GetMarkerGeometry( tableMap, rowIdx, colIdx, '_CellSelected' ) ;
            if ( g.width != geometry.width || g.height != geometry.height )
            {
                this._UnmarkCells( cells, '_CellSelected' ) ;
                return false ;
            }
        }
    }

    this._UnmarkCells( cells, '_CellSelected' ) ;
    return true ;
}

FCKTableHandler.MergeCells = function()
{
    // Get all selected cells.
    var cells = this.GetSelectedCells() ;
    if ( cells.length < 2 )
        return ;

    // Assume the selected cells are already in a rectangular geometry.
    // Because the checking is already done by FCKTableCommand.
    var refCell = cells[0] ;
    var tableMap = this._CreateTableMap( refCell ) ;
    var rowIdx = refCell.parentNode.rowIndex ;
    var colIdx = this._GetCellIndexSpan( tableMap, rowIdx, refCell ) ;

    this._MarkCells( cells, '_SelectedCells' ) ;
    var selectionGeometry = this._GetMarkerGeometry( tableMap, rowIdx, colIdx, '_SelectedCells' ) ;

    var baseColIdx = colIdx - selectionGeometry.x ;
    var baseRowIdx = rowIdx - selectionGeometry.y ;
    var cellContents = FCKTools.GetElementDocument( refCell ).createDocumentFragment() ;
    for ( var i = 0 ; i < selectionGeometry.height ; i++ )
    {
        var rowChildNodesCount = 0 ;
        for ( var j = 0 ; j < selectionGeometry.width ; j++ )
        {
            var currentCell = tableMap[baseRowIdx + i][baseColIdx + j] ;
            while ( currentCell.childNodes.length > 0 )
            {
                var node = currentCell.removeChild( currentCell.firstChild ) ;
                if ( node.nodeType != 1
                    || ( node.getAttribute( 'type', 2 ) != '_moz' && node.getAttribute( '_moz_dirty' ) != null ) )
                {
                    cellContents.appendChild( node ) ;
                    rowChildNodesCount++ ;
                }
            }
        }
        if ( rowChildNodesCount > 0 )
            cellContents.appendChild( FCK.EditorDocument.createElement( 'br' ) ) ;
    }

    this._ReplaceCellsByMarker( tableMap, '_SelectedCells', refCell ) ;
    this._UnmarkCells( cells, '_SelectedCells' ) ;
    this._InstallTableMap( tableMap, refCell.parentNode.parentNode.parentNode ) ;
    refCell.appendChild( cellContents ) ;

    if ( FCKBrowserInfo.IsGeckoLike && ( ! refCell.firstChild ) )
        FCKTools.AppendBogusBr( refCell ) ;

    this._MoveCaretToCell( refCell, false ) ;
}

FCKTableHandler.MergeRight = function()
{
    var target = this.GetMergeRightTarget() ;
    if ( target == null )
        return ;
    var refCell = target.refCell ;
    var tableMap = target.tableMap ;
    var nextCell = target.nextCell ;

    var cellContents = FCK.EditorDocument.createDocumentFragment() ;
    while ( nextCell && nextCell.childNodes && nextCell.childNodes.length > 0 )
        cellContents.appendChild( nextCell.removeChild( nextCell.firstChild ) ) ;

    nextCell.parentNode.removeChild( nextCell ) ;
    refCell.appendChild( cellContents ) ;
    this._MarkCells( [nextCell], '_Replace' ) ;
    this._ReplaceCellsByMarker( tableMap, '_Replace', refCell ) ;
    this._InstallTableMap( tableMap, refCell.parentNode.parentNode.parentNode ) ;

    this._MoveCaretToCell( refCell, false ) ;
}

FCKTableHandler.MergeDown = function()
{
    var target = this.GetMergeDownTarget() ;
    if ( target == null )
        return ;
    var refCell = target.refCell ;
    var tableMap = target.tableMap ;
    var nextCell = target.nextCell ;

    var cellContents = FCKTools.GetElementDocument( refCell ).createDocumentFragment() ;
    while ( nextCell && nextCell.childNodes && nextCell.childNodes.length > 0 )
        cellContents.appendChild( nextCell.removeChild( nextCell.firstChild ) ) ;
    if ( cellContents.firstChild )
        cellContents.insertBefore( FCK.EditorDocument.createElement( 'br' ), cellContents.firstChild ) ;
    refCell.appendChild( cellContents ) ;
    this._MarkCells( [nextCell], '_Replace' ) ;
    this._ReplaceCellsByMarker( tableMap, '_Replace', refCell ) ;
    this._InstallTableMap( tableMap, refCell.parentNode.parentNode.parentNode ) ;

    this._MoveCaretToCell( refCell, false ) ;
}

FCKTableHandler.HorizontalSplitCell = function()
{
    var cells = FCKTableHandler.GetSelectedCells() ;
    if ( cells.length != 1 )
        return ;

    var refCell = cells[0] ;
    var tableMap = this._CreateTableMap( refCell ) ;
    var rowIdx = refCell.parentNode.rowIndex ;
    var colIdx = FCKTableHandler._GetCellIndexSpan( tableMap, rowIdx, refCell ) ;
    var cellSpan = isNaN( refCell.colSpan ) ? 1 : refCell.colSpan ;

    if ( cellSpan > 1 )
    {
        // Splitting a multi-column cell - original cell gets ceil(colSpan/2) columns,
        // new cell gets floor(colSpan/2).
        var newCellSpan = Math.ceil( cellSpan / 2 ) ;
        var newCell = FCK.EditorDocument.createElement( refCell.nodeName ) ;
        if ( FCKBrowserInfo.IsGeckoLike )
            FCKTools.AppendBogusBr( newCell ) ;
        var startIdx = colIdx + newCellSpan ;
        var endIdx = colIdx + cellSpan ;
        var rowSpan = isNaN( refCell.rowSpan ) ? 1 : refCell.rowSpan ;
        for ( var r = rowIdx ; r < rowIdx + rowSpan ; r++ )
        {
            for ( var i = startIdx ; i < endIdx ; i++ )
                tableMap[r][i] = newCell ;
        }
    }
    else
    {
        // Splitting a single-column cell - add a new cell, and expand
        // cells crossing the same column.
        var newTableMap = [] ;
        for ( var i = 0 ; i < tableMap.length ; i++ )
        {
            var newRow = tableMap[i].slice( 0, colIdx ) ;
            if ( tableMap[i].length <= colIdx )
            {
                newTableMap.push( newRow ) ;
                continue ;
            }
            if ( tableMap[i][colIdx] == refCell )
            {
                newRow.push( refCell ) ;
                newRow.push( FCK.EditorDocument.createElement( refCell.nodeName ) ) ;
                if ( FCKBrowserInfo.IsGeckoLike )
                    FCKTools.AppendBogusBr( newRow[newRow.length - 1] ) ;
            }
            else
            {
                newRow.push( tableMap[i][colIdx] ) ;
                newRow.push( tableMap[i][colIdx] ) ;
            }
            for ( var j = colIdx + 1 ; j < tableMap[i].length ; j++ )
                newRow.push( tableMap[i][j] ) ;
            newTableMap.push( newRow ) ;
        }
        tableMap = newTableMap ;
    }

    this._InstallTableMap( tableMap, refCell.parentNode.parentNode.parentNode ) ;
}

FCKTableHandler.VerticalSplitCell = function()
{
    var cells = FCKTableHandler.GetSelectedCells() ;
    if ( cells.length != 1 )
        return ;

    var currentCell = cells[0] ;
    var tableMap = this._CreateTableMap( currentCell ) ;
    var currentRowIndex = currentCell.parentNode.rowIndex ;
    var cellIndex = FCKTableHandler._GetCellIndexSpan( tableMap, currentRowIndex, currentCell ) ;
    // Save current cell colSpan
    var currentColSpan = isNaN( currentCell.colSpan ) ? 1 : currentCell.colSpan ;
    var currentRowSpan = currentCell.rowSpan ;
    if ( isNaN( currentRowSpan ) )
        currentRowSpan = 1 ;

    if ( currentRowSpan > 1 )
    {
        // 1. Set the current cell's rowSpan to 1.
        currentCell.rowSpan = Math.ceil( currentRowSpan / 2 ) ;

        // 2. Find the appropriate place to insert a new cell at the next row.
        var newCellRowIndex = currentRowIndex + Math.ceil( currentRowSpan / 2 ) ;
        var oRow = tableMap[newCellRowIndex] ;
        var insertMarker = null ;
        for ( var i = cellIndex+1 ; i < oRow.length ; i++ )
        {
            if ( oRow[i].parentNode.rowIndex == newCellRowIndex )
            {
                insertMarker = oRow[i] ;
                break ;
            }
        }

        // 3. Insert the new cell to the indicated place, with the appropriate rowSpan and colSpan, next row.
        var newCell = FCK.EditorDocument.createElement( currentCell.nodeName ) ;
        newCell.rowSpan = Math.floor( currentRowSpan / 2 ) ;
        if ( currentColSpan > 1 )
            newCell.colSpan = currentColSpan ;
        if ( FCKBrowserInfo.IsGeckoLike )
            FCKTools.AppendBogusBr( newCell ) ;
        currentCell.parentNode.parentNode.parentNode.rows[newCellRowIndex].insertBefore( newCell, insertMarker ) ;
    }
    else
    {
        // 1. Insert a new row.
        var newSectionRowIdx = currentCell.parentNode.sectionRowIndex + 1 ;
        var newRow = FCK.EditorDocument.createElement( 'tr' ) ;
        var tSection = currentCell.parentNode.parentNode ;
        if ( tSection.rows.length > newSectionRowIdx )
            tSection.insertBefore( newRow, tSection.rows[newSectionRowIdx] ) ;
        else
            tSection.appendChild( newRow ) ;

        // 2. +1 to rowSpan for all cells crossing currentCell's row.
        for ( var i = 0 ; i < tableMap[currentRowIndex].length ; )
        {
            var colSpan = tableMap[currentRowIndex][i].colSpan ;
            if ( isNaN( colSpan ) || colSpan < 1 )
                colSpan = 1 ;
            if ( i == cellIndex )
            {
                i += colSpan ;
                continue ;
            }
            var rowSpan = tableMap[currentRowIndex][i].rowSpan ;
            if ( isNaN( rowSpan ) )
                rowSpan = 1 ;
            tableMap[currentRowIndex][i].rowSpan = rowSpan + 1 ;
            i += colSpan ;
        }

        // 3. Insert a new cell to new row. Set colSpan on the new cell.
        var newCell = FCK.EditorDocument.createElement( currentCell.nodeName ) ;
        if ( currentColSpan > 1 )
            newCell.colSpan = currentColSpan ;
        if ( FCKBrowserInfo.IsGeckoLike )
            FCKTools.AppendBogusBr( newCell    ) ;
        newRow.appendChild( newCell ) ;
    }
}

// Get the cell index from a TableMap.
FCKTableHandler._GetCellIndexSpan = function( tableMap, rowIndex, cell )
{
    if ( tableMap.length < rowIndex + 1 )
        return null ;

    var oRow = tableMap[ rowIndex ] ;

    for ( var c = 0 ; c < oRow.length ; c++ )
    {
        if ( oRow[c] == cell )
            return c ;
    }

    return null ;
}

// Get the cell location from a TableMap. Returns an array with an [x,y] location
FCKTableHandler._GetCellLocation = function( tableMap, cell  )
{
    for ( var i = 0 ; i < tableMap.length; i++ )
    {
        for ( var c = 0 ; c < tableMap[i].length ; c++  )
        {
            if ( tableMap[i][c] == cell  ) return [i,c];
        }
    }
    return null ;
}

// This function is quite hard to explain. It creates a matrix representing all cells in a table.
// The difference here is that the "spanned" cells (colSpan and rowSpan) are duplicated on the matrix
// cells that are "spanned". For example, a row with 3 cells where the second cell has colSpan=2 and rowSpan=3
// will produce a bi-dimensional matrix with the following values (representing the cells):
//        Cell1, Cell2, Cell2, Cell3
//        Cell4, Cell2, Cell2, Cell5
//        Cell6, Cell2, Cell2, Cell7
FCKTableHandler._CreateTableMap = function( refCell )
{
    var table = (refCell.nodeName == 'TABLE' ? refCell : refCell.parentNode.parentNode.parentNode ) ;

    var aRows = table.rows ;

    // Row and Column counters.
    var r = -1 ;

    var aMap = new Array() ;

    for ( var i = 0 ; i < aRows.length ; i++ )
    {
        r++ ;
        if ( !aMap[r] )
            aMap[r] = new Array() ;

        var c = -1 ;

        for ( var j = 0 ; j < aRows[i].cells.length ; j++ )
        {
            var oCell = aRows[i].cells[j] ;

            c++ ;
            while ( aMap[r][c] )
                c++ ;

            var iColSpan = isNaN( oCell.colSpan ) ? 1 : oCell.colSpan ;
            var iRowSpan = isNaN( oCell.rowSpan ) ? 1 : oCell.rowSpan ;

            for ( var rs = 0 ; rs < iRowSpan ; rs++ )
            {
                if ( !aMap[r + rs] )
                    aMap[r + rs] = new Array() ;

                for ( var cs = 0 ; cs < iColSpan ; cs++ )
                {
                    aMap[r + rs][c + cs] = aRows[i].cells[j] ;
                }
            }

            c += iColSpan - 1 ;
        }
    }
    return aMap ;
}

// This function is the inverse of _CreateTableMap - it takes in a table map and converts it to an HTML table.
FCKTableHandler._InstallTableMap = function( tableMap, table )
{
    // Workaround for #1917 : MSIE will always report a cell's rowSpan as 1 as long
    // as the cell is not attached to a row. So we'll need an alternative attribute
    // for storing the calculated rowSpan in IE.
    var rowSpanAttr = FCKBrowserInfo.IsIE ? "_fckrowspan" : "rowSpan" ;

    // Disconnect all the cells in tableMap from their parents, set all colSpan and rowSpan attributes to 1.
    for ( var i = 0 ; i < tableMap.length ; i++ )
    {
        for ( var j = 0 ; j < tableMap[i].length ; j++ )
        {
            var cell = tableMap[i][j] ;
            if ( cell.parentNode )
                cell.parentNode.removeChild( cell ) ;
            cell.colSpan = cell[rowSpanAttr] = 1 ;
        }
    }

    // Scan by rows and set colSpan.
    var maxCol = 0 ;
    for ( var i = 0 ; i < tableMap.length ; i++ )
    {
        for ( var j = 0 ; j < tableMap[i].length ; j++ )
        {
            var cell = tableMap[i][j] ;
            if ( ! cell)
                continue ;
            if ( j > maxCol )
                maxCol = j ;
            if ( cell._colScanned === true )
                continue ;
            if ( tableMap[i][j-1] == cell )
                cell.colSpan++ ;
            if ( tableMap[i][j+1] != cell )
                cell._colScanned = true ;
        }
    }

    // Scan by columns and set rowSpan.
    for ( var i = 0 ; i <= maxCol ; i++ )
    {
        for ( var j = 0 ; j < tableMap.length ; j++ )
        {
            if ( ! tableMap[j] )
                continue ;
            var cell = tableMap[j][i] ;
            if ( ! cell || cell._rowScanned === true )
                continue ;
            if ( tableMap[j-1] && tableMap[j-1][i] == cell )
                cell[rowSpanAttr]++ ;
            if ( ! tableMap[j+1] || tableMap[j+1][i] != cell )
                cell._rowScanned = true ;
        }
    }

    // Clear all temporary flags.
    for ( var i = 0 ; i < tableMap.length ; i++ )
    {
        for ( var j = 0 ; j < tableMap[i].length ; j++)
        {
            var cell = tableMap[i][j] ;
            FCKDomTools.ClearElementJSProperty(cell, '_colScanned' ) ;
            FCKDomTools.ClearElementJSProperty(cell, '_rowScanned' ) ;
        }
    }

    // Insert physical rows and columns to the table.
    for ( var i = 0 ; i < tableMap.length ; i++ )
    {
        var rowObj = FCK.EditorDocument.createElement( 'tr' ) ;
        for ( var j = 0 ; j < tableMap[i].length ; )
        {
            var cell = tableMap[i][j] ;
            if ( tableMap[i-1] && tableMap[i-1][j] == cell )
            {
                j += cell.colSpan ;
                continue ;
            }
            rowObj.appendChild( cell ) ;
            if ( rowSpanAttr != 'rowSpan' )
            {
                cell.rowSpan = cell[rowSpanAttr] ;
                cell.removeAttribute( rowSpanAttr ) ;
            }
            j += cell.colSpan ;
            if ( cell.colSpan == 1 )
                cell.removeAttribute( 'colspan' ) ;
            if ( cell.rowSpan == 1 )
                cell.removeAttribute( 'rowspan' ) ;
        }
        if ( FCKBrowserInfo.IsIE )
        {
            table.rows[i].replaceNode( rowObj ) ;
        }
        else
        {
            table.rows[i].innerHTML = '' ;
            FCKDomTools.MoveChildren( rowObj, table.rows[i] ) ;
        }
    }
}

FCKTableHandler._MoveCaretToCell = function ( refCell, toStart )
{
    var range = new FCKDomRange( FCK.EditorWindow ) ;
    range.MoveToNodeContents( refCell ) ;
    range.Collapse( toStart ) ;
    range.Select() ;
}

FCKTableHandler.ClearRow = function( tr )
{
    // Get the array of row's cells.
    var aCells = tr.cells ;

    // Replace the contents of each cell with "nothing".
    for ( var i = 0 ; i < aCells.length ; i++ )
    {
        aCells[i].innerHTML = '' ;

        if ( FCKBrowserInfo.IsGeckoLike )
            FCKTools.AppendBogusBr( aCells[i] ) ;
    }
}

FCKTableHandler.GetMergeRightTarget = function()
{
    var cells = this.GetSelectedCells() ;
    if ( cells.length != 1 )
        return null ;

    var refCell = cells[0] ;
    var tableMap = this._CreateTableMap( refCell ) ;
    var rowIdx = refCell.parentNode.rowIndex ;
    var colIdx = this._GetCellIndexSpan( tableMap, rowIdx, refCell ) ;
    var nextColIdx = colIdx + ( isNaN( refCell.colSpan ) ? 1 : refCell.colSpan ) ;
    var nextCell = tableMap[rowIdx][nextColIdx] ;

    if ( ! nextCell )
        return null ;

    // The two cells must have the same vertical geometry, otherwise merging does not make sense.
    this._MarkCells( [refCell, nextCell], '_SizeTest' ) ;
    var refGeometry = this._GetMarkerGeometry( tableMap, rowIdx, colIdx, '_SizeTest' ) ;
    var nextGeometry = this._GetMarkerGeometry( tableMap, rowIdx, nextColIdx, '_SizeTest' ) ;
    this._UnmarkCells( [refCell, nextCell], '_SizeTest' ) ;

    if ( refGeometry.height != nextGeometry.height || refGeometry.y != nextGeometry.y )
        return null ;

    return { 'refCell' : refCell, 'nextCell' : nextCell, 'tableMap' : tableMap } ;
}

FCKTableHandler.GetMergeDownTarget = function()
{
    var cells = this.GetSelectedCells() ;
    if ( cells.length != 1 )
        return null ;

    var refCell = cells[0] ;
    var tableMap = this._CreateTableMap( refCell ) ;
    var rowIdx = refCell.parentNode.rowIndex ;
    var colIdx = this._GetCellIndexSpan( tableMap, rowIdx, refCell ) ;
    var newRowIdx = rowIdx + ( isNaN( refCell.rowSpan ) ? 1 : refCell.rowSpan ) ;
    if ( ! tableMap[newRowIdx] )
        return null ;

    var nextCell = tableMap[newRowIdx][colIdx] ;

    if ( ! nextCell )
        return null ;

    // Check if the selected cells are both in the same table section (thead, tfoot or tbody).
    if ( refCell.parentNode.parentNode != nextCell.parentNode.parentNode )
        return null ;

    // The two cells must have the same horizontal geometry, otherwise merging does not makes sense.
    this._MarkCells( [refCell, nextCell], '_SizeTest' ) ;
    var refGeometry = this._GetMarkerGeometry( tableMap, rowIdx, colIdx, '_SizeTest' ) ;
    var nextGeometry = this._GetMarkerGeometry( tableMap, newRowIdx, colIdx, '_SizeTest' ) ;
    this._UnmarkCells( [refCell, nextCell], '_SizeTest' ) ;

    if ( refGeometry.width != nextGeometry.width || refGeometry.x != nextGeometry.x )
        return null ;

    return { 'refCell' : refCell, 'nextCell' : nextCell, 'tableMap' : tableMap } ;
}
